home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 010a / msi170.zip / MSI2.DOC < prev    next >
Text File  |  1992-02-05  |  47KB  |  911 lines

  1.         -----------------------------------------------------------------
  2.         MSI User's Manual                                         Page 18
  3.  
  4.  
  5.  
  6.         Special Menu Commands
  7.  
  8.  
  9.         There   are   several  special commands   available   in   NORMAL 
  10.         OPERATING  mode.    Most  of these are  viewable  either  on  the 
  11.         backdrop screen or by pressing a Control Key and holding it down.  
  12.  
  13.  
  14.         ESC - Exit the MSI Menu System
  15.  
  16.         This  terminates the program's execution.   You will be asked  to 
  17.         verify this command. 
  18.  
  19.  
  20.         ALT-B - Change the Background Color
  21.  
  22.         There  are  eight  different  colors  available  for  the  menus' 
  23.         backdrop screen.   Pressing ALT-B lets you toggle through all  of 
  24.         of the choices.
  25.  
  26.  
  27.         F1 - Help
  28.         
  29.         Display a Help window for the current menu.   You can define your 
  30.         own Help Screens inside the Menus Editor. 
  31.  
  32.  
  33.         F2 - Print an Order Form
  34.         
  35.         If you find yourself using MSI after 30 days, here's a convenient 
  36.         command! 
  37.  
  38.  
  39.         F3 - Set the Screen Blanking Delay
  40.         
  41.         When there has been no activity on the keyboard for the amount of 
  42.         time  set here,  the screen will be blanked.   Even EGA  screens, 
  43.         over  a  period of time,  can have an image 'burned'  into  them.  
  44.         This feature will help extend the life of your monitor's screen. 
  45.  
  46.  
  47.         F5 - Enter the Menus Editor
  48.         
  49.         You MUST be able to see the 'F5 - Menu' window on the left of the 
  50.         screen for this command key to work.  If you don't see the window 
  51.         the Menu Definitions  have been  'locked'   to prevent accidental 
  52.         changes.  Unlock the menus by pressing CTRL-F10. 
  53.  
  54.  
  55.         The following commands are all Control Key commands.   A  special 
  56.         MSI feature lets you view these on screen by pressing and holding 
  57.         a Control Key down.  See Figure 10.
  58.  
  59.         -----------------------------------------------------------------
  60.         MSI User's Manual                                         Page 19
  61.  
  62.  
  63.  
  64.  
  65.       ╔══════════════════════════════════════════════════════════════════╗
  66.       ║                               9:46  April 21, 1991               ║
  67.       ║                                                                  ║
  68.       ║   ┌───────────┐                                                  ║
  69.       ║  █│ F1 - HELP │     ╔═══════════════════════════════════════╗    ║
  70.       ║  █└───────────┘    █║            MSI Sample Menus           ║    ║
  71.       ║  ████████████      █║                                       ║    ║
  72.       ║                    █║      1. Lots of Stepped Menus         ║    ║
  73.       ║                    █║         A 'Text Only' Option...       ║    ║
  74.       ║   ┌───────────┐    █║                                       ║    ║
  75.       ║  █│ F5 - MENU │    █║      2. Non-Stepped Menus             ║    ║
  76.       ║  █└───────────┘    █║         ...could be additional help.  ║    ║
  77.       ║  ████████████      █║                                       ║    ║
  78.       ║                    █║   'Text Only' cannot be selected.     ║    ║
  79.       ║                    █║                                       ║    ║
  80.       ║  ┌─────────────┐   █║      3. Password Menu (PW = Pass)     ║    ║
  81.       ║ █│ ESC To QUIT │   █║                                       ║    ║
  82.       ║ █│  MSI Menus  │   █║      4. Print Document Files...!      ║    ║
  83.       ║ █└─────────────┘   █╚═══════════════════════════════════════╝    ║
  84.       ║ ██████████████     ████████████████████████████████████████      ║
  85.       ║                                                                  ║
  86.       ║                                                                  ║
  87.       ║  Directory: C:\15  Free: 7654321                                 ║
  88.       ╚══════════════════════════════════════════════════════════════════╝
  89.         Figure 11 - CTRL-F2 lets you display the current directory and
  90.                     free disk space.
  91.  
  92.         -----------------------------------------------------------------
  93.         MSI User's Manual                                         Page 20
  94.  
  95.  
  96.  
  97.         CTRL-F1 - Exit Temporarily to DOS
  98.         
  99.         Also  known  as a DOS Shell  command  this  lets  you  leave  MSI 
  100.         temporarily  to  perform  DOS  functions.   When you are ready to 
  101.         return to the menus type; 
  102.  
  103.                                        EXIT
  104.  
  105.         MSI  will remain resident in the computer's memory while you  are 
  106.         in DOS,  allowing you to return to the exact location from  which 
  107.         you left. 
  108.  
  109.  
  110.         CTRL-F2 - Current Directory Toggle
  111.  
  112.         The  bottom screen line will display the Copyright notice  during 
  113.         normal  operation.    CTRL-F2  lets you select between  this  and 
  114.         displaying  the  current working disk and directory.   The  state 
  115.         will be saved as part of the menus data file so that you will  be 
  116.         able to return from Action commands to the same setting.   If you 
  117.         are displaying the directory,  when you return to the program the 
  118.         Copyright  notice  will appear briefly then be replaced with  the 
  119.         directory display.  See Figure 11. 
  120.  
  121.  
  122.         CTRL-F3 & CTRL-F4
  123.  
  124.         These combinations are reserved for future use.
  125.  
  126.  
  127.         CTRL-F5 - Lock the Menu Definitions
  128.  
  129.         Locking  the  current menus makes the Menus  Editor  unavailable.  
  130.         However,  you will still have access to all the commands given in 
  131.         this  section  for use during normal  operations.    The  locking 
  132.         feature lets you protect your menus from accidental changes. 
  133.  
  134.  
  135.         CTRL-F10 - Unlock the Menu Definitions
  136.  
  137.         Use  this command when you want access to the Menus Editor  after 
  138.         locking the menu definitions. 
  139.  
  140.         -----------------------------------------------------------------
  141.         MSI User's Manual                                         Page 21
  142.  
  143.  
  144.  
  145.       ╔══════════════════════════════════════════════════════════════════╗
  146.       ║                               9:46  April 21, 1991               ║
  147.       ║                                                                  ║
  148.       ║   ┌───────────┐                                                  ║
  149.       ║  █│ F1 - HELP │     ╔═══════════════════════════════════════╗    ║
  150.       ║  █└───────────┘    █║            MSI Sample Menus           ║    ║
  151.       ║  ████████████      █║                                       ║    ║
  152.       ║                    █║      1. Lots of Stepped Menus         ║    ║
  153.       ║                    █║         A 'Text Only' Option...       ║    ║
  154.       ║  ┌─────────────┐   █║                                       ║    ║
  155.       ║ █│ ESC To QUIT │   █║      2. Non-Stepped Menus             ║    ║
  156.       ║ █│  MSI Menus  │   █║         ...could be additional help.  ║    ║
  157.       ║ █└─────────────┘   █║                                       ║    ║
  158.       ║ ██████████████     █║   'Text Only' cannot be selected.     ║    ║
  159.       ║                    █║                                       ║    ║
  160.       ║                    █║      3. Password Menu (PW = Pass)     ║    ║
  161.       ║                    █║                                       ║    ║
  162.       ║                    █║      4. Print Document Files...!      ║    ║
  163.       ║                    █╚═══════════════════════════════════════╝    ║
  164.       ║                    ████████████████████████████████████████      ║
  165.       ║                                                                  ║
  166.       ║                                                                  ║
  167.       ║ MSI Menu System 1.60 Copyright (C) 1991, 1992 Larry B. Rice      ║
  168.       ╚══════════════════════════════════════════════════════════════════╝
  169.         Figure 12 - Menus are Locked when the F5 window is not showing.
  170.  
  171.  
  172.       ╔══════════════════════════════════════════════════════════════════╗
  173.       ║                               9:46  April 21, 1991               ║
  174.       ║                                                                  ║
  175.       ║   ┌───────────┐                                                  ║
  176.       ║  █│ F1 - HELP │     ╔═══════════════════════════════════════╗    ║
  177.       ║  █└───────────┘    █║            MSI Sample Menus           ║    ║
  178.       ║  ████████████      █║                                       ║    ║
  179.       ║                    █║      1. Lots of Stepped Menus         ║    ║
  180.       ║                    █║         A 'Text Only' Option...       ║    ║
  181.       ║   ┌───────────┐    █║                                       ║    ║
  182.       ║  █│ F5 - MENU │    █║      2. Non-Stepped Menus             ║    ║
  183.       ║  █└───────────┘    █║         ...could be additional help.  ║    ║
  184.       ║  ████████████      █║                                       ║    ║
  185.       ║                    █║   'Text Only' cannot be selected.     ║    ║
  186.       ║                    █║                                       ║    ║
  187.       ║  ┌─────────────┐   █║      3. Password Menu (PW = Pass)     ║    ║
  188.       ║ █│ ESC To QUIT │   █║                                       ║    ║
  189.       ║ █│  MSI Menus  │   █║      4. Print Document Files...!      ║    ║
  190.       ║ █└─────────────┘   █╚═══════════════════════════════════════╝    ║
  191.       ║ ██████████████     ████████████████████████████████████████      ║
  192.       ║                                                                  ║
  193.       ║                                                                  ║
  194.       ║ MSI Menu System 1.60 Copyright (C) 1991, 1992 Larry B. Rice      ║
  195.       ╚══════════════════════════════════════════════════════════════════╝
  196.         Figure 13 - Unlocked menus may be edited.
  197.  
  198.         -----------------------------------------------------------------
  199.         MSI User's Manual                                         Page 22
  200.  
  201.  
  202.  
  203.         Section III
  204.  
  205.                                   Creating Menus
  206.  
  207.         The Menus Editor
  208.  
  209.  
  210.         Hopefully by now you have examined the Sample menus and are ready 
  211.         to look at the Menus Editor.  First though, you will need to make 
  212.         sure that the Editor has not been 'locked'. 
  213.  
  214.  
  215.         Your  initial  MSI  screen will either look like the one shown in 
  216.         Figure 12 or the one in Figure 13. 
  217.  
  218.  
  219.         If your screen  looks like the one in Figure 12 (only two windows 
  220.         showing  on  the  left  side  of  the  screen)   then  your  menu 
  221.         definitions have been protected.   Locked menus cannot be edited.  
  222.         To unlock the menus press CTRL-F10  (the Control and F10 keys  at 
  223.         the same time).   You will be asked to verify that  the menus are 
  224.         to be unlocked.  Press 'Y' to verify. 
  225.  
  226.  
  227.         Once  unlocked  your  screen  should look like the one  shown  in 
  228.         Figure 13.  Press the F5 key to enter the Menus Editor.  
  229.  
  230.  
  231.         NOTE:   You can enter the Menus Editor from any of your menus (if 
  232.         the  menus  are unlocked,  of course).   This allows you to  make 
  233.         quick  changes  and test them without having to first  return  to 
  234.         your main menu. 
  235.  
  236.         -----------------------------------------------------------------
  237.         MSI User's Manual                                         Page 23
  238.  
  239.  
  240.  
  241.  
  242.  
  243.       ╔══════════════════════════════════════════════════════════════════|
  244.       ║                        ╔═════════════════════════════════════════|
  245.       ║  ╔═══════════════════╗█║ Password: None    Selects: Menu   Type: |
  246.       ║ █║ Name Prompt Help  ║█╚═════════════════════════════════════════|
  247.       ║ █║                   ║███████████████████████████████████████████|
  248.       ║ █║ Prompt Line: No   ║  ╔═══════════════════════════════════════╗|
  249.       ║ █║                   ║ █║          MSI Sample Menus             ║|
  250.       ║ █║ Shadow:  Cursor:  ║ █║                                       ║|
  251.       ║ █║ Yes      Yes      ║ █║      1. Lots of Stepped Menus         ║|
  252.       ║ █║                   ║ █║         A 'Text Only' Option...       ║|
  253.       ║ █║ Stepped  Border:  ║ █║                                       ║|
  254.       ║ █║ No       Double   ║ █║      2. Non-Stepped Menus             ║|
  255.       ║ █║                   ║ █║         ...could be additional help.  ║|
  256.       ║ █║    Menu Colors    ║ █║                                       ║|
  257.       ║ █║ Back:    Fore:    ║ █║   'Text Only' cannot be selected.     ║|
  258.       ║ █║ LtGray   Blue     ║ █║                                       ║|
  259.       ║ █║                   ║ █║      3. Password Menu (PW = Pass)     ║|
  260.       ║ █║   Option Colors   ║ █║                                       ║|
  261.       ║ █║ Back:    Fore:    ║ █║      4. Print Document Files..!       ║|
  262.       ║ █║ LtGray   Black    ║ █╚═══════════════════════════════════════╝|
  263.       ║ █╚═══════════════════╝ ████████████████████████████████████████  |
  264.       ║ ████████████████████                                             |
  265.       ║                                                                  |
  266.       ║  Press ALT-Q to Quit    Select  F2 Edit  F3 Move  F4 Define  F10 |
  267.       ╚══════════════════════════════════════════════════════════════════|
  268.         Figure 14 - The initial Menus Editor screen with the Sample 
  269.                     Menus.
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.               Highlight a selection and press RETURN to change
  279.  
  280.  
  281.  
  282.                     to a sub-menu inside the Menus Editor.
  283.  
  284.  
  285.         -----------------------------------------------------------------
  286.         MSI User's Manual                                         Page 24
  287.  
  288.  
  289.  
  290.         Figure 14 shows the initial Menus Editor screen.  Notice the Menu 
  291.         Options windows that open to the left and top of the menu window.  
  292.         Also,  notice the Command Assistance Line (CAL) has replaced  the 
  293.         copyright  notice on the bottom of the screen.   Watch the CAL as 
  294.         you enter various editing modes or perform editing functions.  It 
  295.         will  keep you up-to-date on the commands available  at any given 
  296.         time while you are inside the Menus Editor. 
  297.  
  298.  
  299.         The Menu Options inside the windows are discussed individually in 
  300.         the  next section.   These options allow you to define the 'look' 
  301.         of the menu and how each menu selection will operate.  
  302.         
  303.         
  304.         MSI  allows  you to see changes in your menus  immediately.    To 
  305.         illustrate this,  press the 'D'  key.   This will turn the menu's 
  306.         shadow  on and off.   The menu will immediately be redrawn  using 
  307.         the new setting.  Watch the 'Shadow' setting in the option window 
  308.         to  the left as you press the key.   When the Shadow  setting  is 
  309.         'Yes'  the menu will be drawn with an underlying shadow for a 3-D 
  310.         effect.   When the setting is 'No'  the shadow will not be  used, 
  311.         giving you a flat menu window. 
  312.  
  313.  
  314.         The Shadow setting is an example of a 'Toggled' setting.  All of 
  315.         the following are also toggled settings:
  316.         
  317.             1. (T)ype - Top Window: Normal or Text Only
  318.             2. Prompt (L)ine - Yes or No
  319.             3. Sha(d)ow - Yes or No
  320.             4. (C)ursor (Bar) - Yes or No
  321.             5. St(e)pped - Yes or No
  322.         
  323.         
  324.         Except  for the Name,  Prompt and Help options at the top of  the 
  325.         left  option window,  all of the other settings are changed using 
  326.         the  left  and right cursor keys.   Pressing the red command  key 
  327.         will  move  the cursor to the black boxed area to  the  right  or 
  328.         immediately below the setting selected.   Use the cursor keys  to 
  329.         change settings and press RETURN.   The CAL line will provide on-
  330.         screen help for this. 
  331.  
  332.  
  333.         NOTE:   To  change  menus  while inside the  Editor,   place  the 
  334.         highlight bar on an option and press RETURN.  Actions will NOT be 
  335.         executed while inside the Editor. 
  336.  
  337.         -----------------------------------------------------------------
  338.         MSI User's Manual                                         Page 25
  339.  
  340.  
  341.  
  342.       ╔══════════════════════════════════════════════════════════════════|
  343.       ║                        ╔═════════════════════════════════════════|
  344.       ║  ╔═══════════════════╗█║ Password: None    Selects: Menu   Type: |
  345.       ║ █║ Name Prompt Help  ║█╚═════════════════════════════════════════|
  346.       ║ █║                   ║███████████████████████████████████████████|
  347.       ║ █║ Prompt Line: No   ║  ╔═══════════════════════════════════════╗|
  348.       ║ █║                   ║ █║          MSI Sample Menus             ║|
  349.       ║ █║ Shadow:  Cursor:  ║ █║                                       ║|
  350.       ║ █║ Yes      Yes      ║ █║      1. Lots of Stepped Menus         ║|
  351.       ║ █║                   ║ █║ > This line is being edited_          ║|
  352.       ║ █║ Stepped: Border:  ║ █║                                       ║|
  353.       ║ █║ No       Double   ║ █║      2. Non-Stepped Menus             ║|
  354.       ║ █║                   ║ █║         ...could be additional help.  ║|
  355.       ║ █║    Menu Colors    ║ █║                                       ║|
  356.       ║ █║ Back:    Fore:    ║ █║   'Text Only' cannot be selected.     ║|
  357.       ║ █║ LtGray   Blue     ║ █║                                       ║|
  358.       ║ █║                   ║ █║      3. Password Menu (PW = Pass)     ║|
  359.       ║ █║   Option Colors   ║ █║                                       ║|
  360.       ║ █║ Back:    Fore:    ║ █║      4. Print Document Files..!       ║|
  361.       ║ █║ LtGray   Black    ║ █╚═══════════════════════════════════════╝|
  362.       ║ █╚═══════════════════╝ ████████████████████████████████████████  |
  363.       ║ ████████████████████                                             |
  364.       ║                                                                  |
  365.       ║  Press ENTER to Accept or ESC to Cancel    Home End Ins Del to Ed|
  366.       ╚══════════════════════════════════════════════════════════════════|
  367.         Figure 15 - F2 adds or edits the highlighted menu line.
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.                          Start the program with RUNMSI...
  376.                  
  377.            ┌──────────────────────────────────────────────────────────┐
  378.            │    ╔══════════╗   Exits to RUNMSI   ╔════════════╗       │
  379.            │    ║ Action   ║  ─────────────────> ║   RUNMSI   ║       │
  380.            │    ║ Selected ║  <───────────────── ║ Batch File ║       │
  381.            │    ╚══════════╝    Returns to DIR   ╚════════════╝       │
  382.            │     Actions         & Calls MSI         ^     │ Calls    │
  383.            │     Written to                     DOS  │     │ DOS      │
  384.            │     ACT.BAT                        Done │     v          │
  385.            │    ╔════════════╗   Executes Your   ╔════════════╗       │
  386.            │    ║  ACT.BAT   ║ <──────────────── ║    DOS     ║       │
  387.            │    ║ Batch File ║  Action Commands  ║            ║       │
  388.            │    ╚════════════╝                   ╚════════════╝       │
  389.            └──────────────────────────────────────────────────────────┘
  390.              Figure 16 - Command Flow for an Action.
  391.  
  392.         -----------------------------------------------------------------
  393.         MSI User's Manual                                         Page 26
  394.  
  395.  
  396.  
  397.         A menu may have up to eleven  user selectable options defined, if 
  398.         a Prompt Line is not used.   Otherwise it may contain up to nine. 
  399.         Creating  an option is as simple as moving the Cursor Bar to  the 
  400.         menu line that  you want to hold the selection and  pressing  F2.  
  401.         Enter  the  option string and press RETURN when it reads the  way 
  402.         you want. 
  403.  
  404.  
  405.         There  must  be  at least one character on the line  for  MSI  to 
  406.         recognize  it as an option.   MSI uses the first character of the 
  407.         string as the option 'command key';  that is, a  user selects the 
  408.         option  by  pressing the first character of  the  option  string.  
  409.         (The Cursor Bar may also be used, if activated.)   Some or all of 
  410.         the  options  on a menu may be defined as  'Text  Only'.    These 
  411.         options  are NOT selectable.   They allow you to  enter  extended 
  412.         selection descriptions, notes or help text on the menu itself. 
  413.  
  414.  
  415.         Each  selectable  menu item will cause some type of action to  be 
  416.         taken.   This might display a sub-menu, send one or more commands 
  417.         to DOS for execution, or both.  The 'Selects:' setting determines 
  418.         how  the highlighted selection  will  behave.   Your choices  are 
  419.         Menu, Action, Dual and Rsidnt.
  420.  
  421.  
  422.                              How Actions are executed.
  423.  
  424.  
  425.       ══>>  MSI will NOT be Resident for ACTION.
  426.  
  427.       ══>>  MSI WILL remain Resident for RSIDNT.
  428.         
  429.         There are only two batch files used by MSI;  RUNMSI.BAT which  is 
  430.         the program control batch file, and ACT.BAT which is created from 
  431.         your  commands each time an Action option is selected.   For each 
  432.         Action selection made,  MSI will make a fresh copy of  ACT.BAT by 
  433.         copying the contents of an 'Action Window' to it.  MSI terminates 
  434.         and RUNMSI calls ACT.BAT  which DOS reads and executes.  When DOS 
  435.         has completed all of the commands in ACT.BAT, control is returned 
  436.         to  RUNMSI.BAT,  which then executes MSI once more.    Figure  16 
  437.         illustrates this process. 
  438.  
  439.  
  440.         IMPORTANT -  For RUNMSI.BAT to operate correctly when Actions are 
  441.         completed, MSI appends commands to your Action commands to return 
  442.         to  the  Home  directory  when  the  commands  are  done.     See 
  443.         'Installing  MSI'   for details. 
  444.  
  445.         -----------------------------------------------------------------
  446.         MSI User's Manual                                         Page 27
  447.  
  448.  
  449.  
  450.  
  451.  
  452.            ┌──────────────────────────────────────────────────────────┐
  453.            │    ╔══════════╗    Dual Selected    ╔════════════╗       │
  454.            │    ║   Dual   ║  ─────────────────> ║  DOS       ║       │
  455.            │    ║ Selected ║  Write 1st Actions  ║  executes  ║       │
  456.            │    ╚══════════╝      to ACT.BAT     ║  ACT.BAT   ║       │
  457.            │      ^ Return to                    ╚════════════╝       │
  458.            │      │ Calling Menu                 Display   │          │
  459.            │    ╔════════════╗                   Sub-Menu  v          │
  460.            │    ║  DOS       ║    ESC Pressed    ╔════════════╗       │
  461.            │    ║  executes  ║ <──────────────── ║    Dual    ║       │
  462.            │    ║  ACT.BAT   ║ Write 2nd Actions ║  Sub-Menu  ║       │
  463.            │    ╚════════════╝    to ACT.BAT     ╚════════════╝       │
  464.            └──────────────────────────────────────────────────────────┘
  465.              Figure 17 - Command flow for Dual.
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.         ┌─────────────────────────────────────────────────────────────────┐
  476.         │   ╔═══════════╗  Change  ╔═══════════╗  Change  ╔═══════════╗   │
  477.         │   ║    MSI    ║ ───────> ║   Dual    ║ ───────> ║   Dual    ║   │
  478.         │   ║   Menus   ║   Dir    ║ Sub-Menu  ║   Dir    ║ Sub-Menu  ║   │
  479.         │   ╚═══════════╝          ╚═══════════╝          ╚═══════════╝   │
  480.         │         │                                             │         │
  481.         │           <Change Back - ESC <    <Change Back - ESC <          │
  482.         └─────────────────────────────────────────────────────────────────┘
  483.           Figure 18 - Using Dual options to change working directories.
  484.  
  485.         -----------------------------------------------------------------
  486.         MSI User's Manual                                         Page 28
  487.  
  488.  
  489.  
  490.  
  491.                               How Dual is executed.
  492.  
  493.  
  494.       ══>>  MSI remains Resident for Dual Actions.
  495.  
  496.         
  497.         A Dual selection lets you define TWO sets of Action commands  and 
  498.         a sub-menu.   MSI will execute the  FIRST set of Action commands,  
  499.         display the sub-menu and wait for further selections.  The second 
  500.         set  of  Action  commands  will be executed when the ESC  key  is 
  501.         pressed to  return to the previous (calling)  menu.   You are not 
  502.         required  to define both sets of Actions;  just leave the  window 
  503.         blank  if it is not needed.   Figure 17  illustrates the  command 
  504.         flow of Dual. 
  505.         
  506.  
  507.         The Dual Action was specifically designed to help in  controlling 
  508.         the use of 'Terminate and Stay Resident'  (TSR)  programs.    The 
  509.         first Action can load and/or configure the TSR.    The menu would 
  510.         then   provide help with TSR features,  hotkeys or control   flow 
  511.         while the TSR is active.    The second second set of actions  can 
  512.         then deactivate or unload the TSR.    Of course,   there are many 
  513.         variations on  this, the only limit being your imagination. 
  514.  
  515.  
  516.         Another  application  of  the Dual action is  to  change  working 
  517.         directories  as  you progress to and from your  sub-menus.    See 
  518.         Figure 18. 
  519.         
  520.  
  521.         MSI  will display a DOS screen when each set of the  Dual  Action 
  522.         commands is executed.   This allows DOS, or your TSRs, to display 
  523.         messages.  You may want to liberally use the DOS 'Pause'  command 
  524.         in your Actions to allow yourself or  others a chance to read the 
  525.         messages.  You can also use the redirect commands ( > and >> ) to 
  526.         send the messages to a file or other device.   Refer to your  DOS 
  527.         manual for more on redirection. 
  528.  
  529.  
  530.         In Defining (F4) a Dual action you will first define the PRE-menu 
  531.         Action then the POST-menu Action, then the sub-menu itself. 
  532.  
  533.         -----------------------------------------------------------------
  534.         MSI User's Manual                                         Page 29
  535.  
  536.  
  537.       ╔══════════════════════════════════════════════════════════════════|
  538.       ║                        ╔═════════════════════════════════════════|
  539.       ║  ╔═══════════════════╗█║ Password: None    Selects: Menu   Type: |
  540.       ║ █║ Name Prompt Help  ║█╚═════════════════════════════════════════|
  541.       ║ █║                   ║███████████████████████████████████████████|
  542.       ║ █║ Prompt Line: No   ║  ╔═══════════════════════════════════════╗|
  543.       ║ █║                   ║ █║          MSI Sample Menus             ║|
  544.       ║ █║ Shadow:  Cursor:  ║ █║                                       ║|
  545.       ║ █║ Yes      Yes      ║ █║       1. Lots of Stepped Menus        ║|
  546.       ║ █║             ╔═════╩══╩═════════════════════════╗tion...      ║|
  547.       ║ █║ Stepped: Bor║  Define MENU for this option.    ║             ║|
  548.       ║ █║ No       Dou║         Continue? (Y/N) _        ║             ║|
  549.       ║ █║             ╚═════╦══╦═════════════════════════╝ional help.  ║|
  550.       ║ █║    Menu Colors    ║ █║                                       ║|
  551.       ║ █║ Back:    Fore:    ║ █║   'Text Only' cannot be selected.     ║|
  552.       ║ █║ LtGray   Blue     ║ █║                                       ║|
  553.       ║ █║                   ║ █║      3. Password Menu (PW = Pass)     ║|
  554.       ║ █║   Option Colors   ║ █║                                       ║|
  555.       ║ █║ Back:    Fore:    ║ █║      4. Print Document Files..!       ║|
  556.       ║ █║ LtGray   Black    ║ █╚═══════════════════════════════════════╝|
  557.       ║ █╚═══════════════════╝ ████████████████████████████████████████  |
  558.       ║ ████████████████████                                             |
  559.       ║                                                                  |
  560.       ║  Press ALT-Q to Quit    Select  F2 Edit  F3 Move  F4 Define  F10 |
  561.       ╚══════════════════════════════════════════════════════════════════|
  562.         Figure 19 - Memory will be allocated for a new menu.
  563.  
  564.  
  565.       ╔══════════════════════════════════════════════════════════════════|
  566.       ║                        ╔═════════════════════════════════════════|
  567.       ║  ╔═══════════════════╗█║ Password: None    Selects: Menu   Type: |
  568.       ║ █║ Name Prompt Help  ║█╚═════════════════════════════════════════|
  569.       ║ █║                   ║███████████████████████████████████████████|
  570.       ║ █║ Prompt Line: No   ║  ╔═══════════════════════════════════════╗|
  571.       ║ █║                   ║ █║                                       ║|
  572.       ║ █║ Shadow:  Cursor:  ║ █║                                       ║|
  573.       ║ █║ Yes      Yes      ║ █║                                       ║|
  574.       ║ █║                   ║ █║                                       ║|
  575.       ║ █║ Stepped: Border:  ║ █║                                       ║|
  576.       ║ █║ No       Double   ║ █║                                       ║|
  577.       ║ █║                   ║ █║                                       ║|
  578.       ║ █║    Menu Colors    ║ █║                                       ║|
  579.       ║ █║ Back:    Fore:    ║ █║                                       ║|
  580.       ║ █║ LtGray   Black    ║ █║                                       ║|
  581.       ║ █║                   ║ █║                                       ║|
  582.       ║ █║   Option Colors   ║ █║                                       ║|
  583.       ║ █║ Back:    Fore:    ║ █║                                       ║|
  584.       ║ █║ LtGray   Black    ║ █╚═══════════════════════════════════════╝|
  585.       ║ █╚═══════════════════╝ ████████████████████████████████████████  |
  586.       ║ ████████████████████                                             |
  587.       ║                                                                  |
  588.       ║  Press ALT-Q to Quit    Select  F2 Edit  F3 Move  F4 Define  F10 |
  589.       ╚══════════════════════════════════════════════════════════════════|
  590.         Figure 20 - The new sub-menu is drawn using default settings.
  591.  
  592.         -----------------------------------------------------------------
  593.         MSI User's Manual                                         Page 30
  594.  
  595.  
  596.  
  597.         Creating a Sub-Menu
  598.  
  599.  
  600.         MSI has default settings for menus and option strings.   The menu 
  601.         defaults  are  shown in Figure 20.   These allow you  to  quickly 
  602.         define  sub-menus and their items.    To see how these work,  try 
  603.         defining a new item displaying a sub-menu using the Sample Menus. 
  604.  
  605.  
  606.         Move  the  Cursor  Bar to a blank menu line and press  F2.    The 
  607.         familiar  blinking  underscore cursor  will appear on  the  first 
  608.         editable space on the line.  Enter the following: 
  609.           
  610.                 New Sub-menu_
  611.  
  612.         and  press  RETURN (ENTER).   This defines a new selectable  menu 
  613.         item. 
  614.         
  615.         
  616.         You  can view the selection in normal operation by pressing ALT-Q 
  617.         to  Quit the Menus Editor.   Note that the new selection  can  be 
  618.         highlighted with the Cursor Bar or by pressing the N key ('N'  is 
  619.         the first letter of the option string).  However, since an action 
  620.         has  not  yet been defined for this option,  nothing  will happen 
  621.         when it is selected. 
  622.  
  623.  
  624.         To define a sub-menu for this new item,  press F5 to re-enter the 
  625.         Menus  Editor  and move the Cursor Bar to highlight the item  (if 
  626.         it's not already there).   Make sure 'Selects:'  is set to 'Menu' 
  627.         in the window directly above the menu, then press  F4 to 'Define' 
  628.         an operation.  (Function Keys are shown on CAL.) 
  629.  
  630.  
  631.         You should now be looking at the window shown in Figure 19.   The 
  632.         '..Continue?'  window appears any time a new operation is defined 
  633.         for a menu selection.   MSI will require some additional computer 
  634.         memory for each item defined (see the Technical Note  at the  end 
  635.         of  this section).   This window lets you back out if  the Define 
  636.         key  was  pressed  by mistake,  keeping MSI's  memory  use  to  a 
  637.         minimum.  Press Y to continue.  
  638.         
  639.  
  640.         The  new  sub-menu  will appear directly atop the  previous  menu 
  641.         since  the  default  is non-stepped (Figure 20).    The  sub-menu 
  642.         window  is  now  ready for you to add  item  strings  and  modify 
  643.         settings to create the menu you desire. 
  644.  
  645.         -----------------------------------------------------------------
  646.         MSI User's Manual                                         Page 31
  647.  
  648.  
  649.  
  650.       ╔══════════════════════════════════════════════════════════════════╗
  651.       ║                               9:46  April 21, 1991               ║
  652.       ║                                                                  ║
  653.       ║   ┌───────────┐                                                  ║
  654.       ║  █│ F1 - HELP │     ╔═══════════════════════════════════════╗    ║
  655.       ║  █└───────────┘    █║                                       ║    ║
  656.       ║  ████████████      █║                                       ║    ║
  657.       ║                    █║                                       ║    ║
  658.       ║                    █║                                       ║    ║
  659.       ║   ┌───────────┐    █║                                       ║    ║
  660.       ║  █│ F5 - MENU │    █║                                       ║    ║
  661.       ║  █└───────────┘    █║                                       ║    ║
  662.       ║  ████████████      █║                                       ║    ║
  663.       ║                    █║                                       ║    ║
  664.       ║                    █║                                       ║    ║
  665.       ║  ┌─────────────┐   █║                                       ║    ║
  666.       ║ █│     ESC     │   █║                                       ║    ║
  667.       ║ █│  Prev Menu  │   █║                                       ║    ║
  668.       ║ █└─────────────┘   █╚═══════════════════════════════════════╝    ║
  669.       ║ ██████████████     ████████████████████████████████████████      ║
  670.       ║                                                                  ║
  671.       ║                                                                  ║
  672.       ║ MSI Menu System 1.60 Copyright (C) 1991, 1992 Larry B. Rice      ║
  673.       ╚══════════════════════════════════════════════════════════════════╝
  674.         Figure 21 -  The New Sub-Menu in normal operating mode is a blank 
  675.                      window. 
  676.  
  677.         -----------------------------------------------------------------
  678.         MSI User's Manual                                         Page 32
  679.  
  680.         
  681.         
  682.         
  683.         First,   though,   you  might like to see how  the  new  sub-menu 
  684.         displays in normal operation. 
  685.  
  686.  
  687.         Press  ESC  to  return to the previous menu and  press  ALT-Q  to 
  688.         return to normal operation.  Now select the 'New Sub-menu' option 
  689.         either by pressing 'N'  or by highlighting it with the Cursor Bar 
  690.         and pressing RETURN (ENTER).    Your  newly created  menu will be 
  691.         displayed.   You can now press F5  to return to the Menus  Editor 
  692.         and finish defining the new menu,  or press ESC to return to  the 
  693.         previous menu.  See Figure 21. 
  694.  
  695.  
  696.  
  697.  
  698.                         Technical Note - Memory Allocation
  699.         
  700.         MSI uses a technique known as 'Dynamic Memory Allocation'.   This 
  701.         means  that  MSI will allocate memory on an  'as-needed'   basis, 
  702.         allowing MSI to reduce memory demands to a minimum,  rather  than 
  703.         reserving a large block of memory that will probably never all be 
  704.         needed.   The window in Figure 19, or one similar to it,  appears 
  705.         anytime  a  new  block of memory is about to be  allocated.   The 
  706.         individual allocations are: 
  707.  
  708.  
  709.                              New Menu   -  1131 bytes
  710.                              New Action -  1020 bytes
  711.                              New Dual   -  3171 bytes
  712.                              New Rsidnt -  1020 bytes
  713.  
  714.         -----------------------------------------------------------------
  715.         MSI User's Manual                                         Page 33
  716.  
  717.  
  718.  
  719.       ╔══════════════════════════════════════════════════════════════════|
  720.       ║                        ╔═════════════════════════════════════════|
  721.       ║  ╔═══════════════════╗█║ Password: None    Selects: Menu   Type: |
  722.       ║ █║ Name Prompt Help  ║█╚═════════════════════════════════════════|
  723.       ║ █║                   ║███████████████████████████████████████████|
  724.       ║ █║ Prompt Line: No   ║  ╔═══════════════════════════════════════╗|
  725.       ║ █║                   ║ █║    Adding a Menu Name_                ║|
  726.       ║ █║ Shadow:  Cursor:  ║ █║                                       ║|
  727.       ║ █║ Yes      Yes      ║ █║                                       ║|
  728.       ║ █║                   ║ █║                                       ║|
  729.       ║ █║ Stepped: Border:  ║ █║                                       ║|
  730.       ║ █║ No       Double   ║ █║                                       ║|
  731.       ║ █║                   ║ █║                                       ║|
  732.       ║ █║    Menu Colors    ║ █║                                       ║|
  733.       ║ █║ Back:    Fore:    ║ █║                                       ║|
  734.       ║ █║ LtGray   Black    ║ █║                                       ║|
  735.       ║ █║                   ║ █║                                       ║|
  736.       ║ █║   Option Colors   ║ █║                                       ║|
  737.       ║ █║ Back:    Fore:    ║ █║                                       ║|
  738.       ║ █║ LtGray   Black    ║ █╚═══════════════════════════════════════╝|
  739.       ║ █╚═══════════════════╝ ████████████████████████████████████████  |
  740.       ║ ████████████████████                                             |
  741.       ║                                                                  |
  742.       ║  Press ENTER to Accept or ESC to Cancel    Home End Ins Del to Ed|
  743.       ╚══════════════════════════════════════════════════════════════════|
  744.         Figure 22 - Press N to add or edit a menu Name.
  745.  
  746.  
  747.       ╔══════════════════════════════════════════════════════════════════|
  748.       ║                        ╔═════════════════════════════════════════|
  749.       ║  ╔═══════════════════╗█║ Password: None    Selects: Menu   Type: |
  750.       ║ █║ Name Prompt Help  ║█╚═════════════════════════════════════════|
  751.       ║ █║                   ║███████████████████████████████████████████|
  752.       ║ █║ Prompt Line: No   ║  ╔═══════════════════════════════════════╗|
  753.       ║ █║                   ║ █║                                       ║|
  754.       ║ █║ Shadow:  Cursor:  ║ █║                                       ║|
  755.       ║ █║ Yes      Yes      ║ █║                                       ║|
  756.       ║ █║                   ║ █║                                       ║|
  757.       ║ █║ Stepped: Border:  ║ █║                                       ║|
  758.       ║ █║ No       Double   ║ █║                                       ║|
  759.       ║ █║                   ║ █║                                       ║|
  760.       ║ █║    Menu Colors    ║ █║                                       ║|
  761.       ║ █║ Back:    Fore:    ║ █║                                       ║|
  762.       ║ █║ LtGray   Black    ║ █║                                       ║|
  763.       ║ █║                   ║ █║                                       ║|
  764.       ║ █║   Option Colors   ║ █║                                       ║|
  765.       ║ █║ Back:    Fore:    ║ █║         Adding a Prompt Line_         ║|
  766.       ║ █║ LtGray   Black    ║ █╚═══════════════════════════════════════╝|
  767.       ║ █╚═══════════════════╝ ████████████████████████████████████████  |
  768.       ║ ████████████████████                                             |
  769.       ║                                                                  |
  770.       ║  Press ENTER to Accept or ESC to Cancel    Home End Ins Del to Ed|
  771.       ╚══════════════════════════════════════════════════════════════════|
  772.         Figure 23 - Press P to add or edit a menu Prompt Line.
  773.  
  774.         -----------------------------------------------------------------
  775.         MSI User's Manual                                         Page 34
  776.  
  777.         
  778.         
  779.                   
  780.  
  781.         The Menu Settings
  782.         
  783.  
  784.         This  section contains detailed discussions of all  the  settings 
  785.         available  in the two Menu Option windows.   The command key  for 
  786.         each  setting  will  be  found immediately to the  right  of  the 
  787.         setting title.    The  settings are given in the order that  they 
  788.         appear  in each window,  beginning with the General Menu Settings 
  789.         on the left side of the screen. 
  790.  
  791.         NOTE: MSI will recognize either upper or lower case command keys.
  792.  
  793.  
  794.         The General Menu Settings
  795.  
  796.         The  General  Menu  Options window is the larger  window  located 
  797.         immediately to the left of the menu window itself. 
  798.  
  799.  
  800.         Name: - N -   (Figure 22)
  801.         
  802.         This  is the name to print at the top of the menu.   Press  N  to 
  803.         move the cursor to the first line of the menu window.   CAL  will 
  804.         display the editor commands available.   Use the left  and  right 
  805.         cursor keys, Home, and End to position the cursor on the line and 
  806.         begin typing.  The Insert, Delete and Back Space keys may also be 
  807.         used.  See "Editor Commands" for more information. 
  808.  
  809.  
  810.         Prompt: - P -  (Figure 23)
  811.  
  812.         Using Prompt Lines at the bottom of your menus is optional.  When 
  813.         defined, MSI will display the prompt string on the bottom line of 
  814.         the  menu window and place a blinking cursor immediately  to  the 
  815.         right of it.   Press P to move the cursor to the Prompt Line  and 
  816.         enter  a string.   The prompt has no functional job other than to 
  817.         indicate to  the user that MSI is waiting for input.   If you  do 
  818.         define  a prompt  you  will only have nine selection lines on the 
  819.         menu.   MSI leaves a blank line above  the prompt to make it more 
  820.         distinguishable. 
  821.  
  822.         -----------------------------------------------------------------
  823.         MSI User's Manual                                         Page 35
  824.  
  825.  
  826.  
  827.       ╔══════════════════════════════════════════════════════════════════|
  828.       ║                        ╔═════════════════════════════════════════|
  829.       ║  ╔═══════════════════╗█║ Password: None    Selects: Menu   Type: |
  830.       ║ █║ Name Prompt Help  ║█╚═════════════════════════════════════════|
  831.       ║ █║                   ║███████████████████████████████████████████|
  832.       ║ █║ Prompt Line: No   ║  ╔═══════════════════════════════════════╗|
  833.       ║ █║               ┌───╨──╜─────────────────────────────────┐     ║|
  834.       ║ █║ Shadow:  Curs█│ _                                      │     ║|
  835.       ║ █║ Yes      Yes █│ Press F5 to enter the Menus Editor.    │     ║|
  836.       ║ █║              █│                                        │     ║|
  837.       ║ █║ Stepped: Bord█│ CTRL-F5 'Locks' defined Menus.         │     ║|
  838.       ║ █║ No       Doub█│                                        │     ║|
  839.       ║ █║              █│ CTRL-F10 'Unlocks' the Menus Editor.   │     ║|
  840.       ║ █║    Menu Color█│                                        │     ║|
  841.       ║ █║ Back:    Fore█│ Press CTRL for additional Control Keys.│     ║|
  842.       ║ █║ LtGray   Blac█│                                        │     ║|
  843.       ║ █║              █│ Press F2 to print a Registration Form. │     ║|
  844.       ║ █║   Option Colo█└────────────────────────────────────────┘     ║|
  845.       ║ █║ Back:    Fore█████████████████████████████████████████       ║|
  846.       ║ █║ LtGray   Black    ║ █╚═══════════════════════════════════════╝|
  847.       ║ █╚═══════════════════╝ ████████████████████████████████████████  |
  848.       ║ ████████████████████                                             |
  849.       ║                                                                  |
  850.       ║  ALT-Q to Quit  ESC Cancels Line Changes      Home End Ins Del to|
  851.       ╚══════════════════════════════════════════════════════════════════|
  852.         Figure 24 - Menu's Help screen opened for editing.
  853.  
  854.         -----------------------------------------------------------------
  855.         MSI User's Manual                                         Page 36
  856.           
  857.  
  858.  
  859.         Help: - H -  (Figure 24)
  860.  
  861.         During  normal operation a Help Screen is available for each menu 
  862.         by pressing F1.  The H command allows you to edit the contents of 
  863.         the  Help Screen for the current menu.   See the  section  titled 
  864.         'Editor  Commands'   for details on each of the editing  commands 
  865.         available to you. 
  866.  
  867.  
  868.         Prompt Line: - P -  (Toggle)
  869.  
  870.         When set to 'Yes'  and a prompt string has been defined, MSI will 
  871.         display  the string on the bottom line of the menu,  followed  by 
  872.         the  familiar blinking underscore cursor.   This will reduce  the 
  873.         maximum number of menu selections to nine.  When set to 'No'  the 
  874.         prompt string will not be displayed, even if it has been defined. 
  875.         Both the Cursor Bar and Prompt Line may be used on a menu. 
  876.  
  877.  
  878.         Shadowed: - D -  (Toggle)
  879.  
  880.         Shadows  beneath the menu windows give the menu a 3-D appearance.  
  881.         Press  D  to turn a menu's shadow on or off.
  882.  
  883.  
  884.         Cursor: - C -  (Toggle)
  885.  
  886.         If  set  to  'Yes'  then you will be able to use the up and  down 
  887.         cursor  keys  to  highlight a menu item with a Cursor  Bar,   and 
  888.         select it by pressing RETURN.  When set to 'No' the Cursor Bar is 
  889.         disabled for the current menu.  Items may be selected by pressing 
  890.         the first  character of the item string, even when the Cursor Bar 
  891.         is used. 
  892.  
  893.  
  894.         Stepped: - E -  (Toggle)
  895.  
  896.         This  is  a special feature that allows you to  layer  subsequent 
  897.         sub-menus  slightly offset from each other.   Stepped menus  give 
  898.         the viewer 'depth perspective';  an important visual reference as 
  899.         to  location within a set of sub-menus.   Press E to Step or  un-
  900.         Step the current menu.
  901.  
  902.  
  903.         Border: - R -
  904.  
  905.         Several  border options are available to help  you  individualize 
  906.         each  of  your sub-menus.   Press R and use the  right  and  left 
  907.         cursor  keys  to change the value.   When you  have  located  the 
  908.         border  you would like to use,  press RETURN.
  909.  
  910.  
  911.